---
type: decision
title: 0001 Evidence First Testing
description: Record test coverage as evidence URIs on rows, never as standalone test documentation.
tags: [decision]
status: accepted
timestamp: {{DATE}}
---
<!-- ✂ docujoint template sample — replace with your own content, then delete this comment. -->
# 0001 Evidence First Testing

## Context
Prose documentation about tests drifts within weeks: suites are renamed,
cases added and removed, and nobody updates the doc. Meanwhile the questions
that matter — "is this unhappy path proven?" — need row-level answers.

## Decision
Tests are cited as `test://` evidence on the exact feature or scenario row
they prove (see [Testing Conventions](</Engineering/Testing Conventions.md>)).
Coverage states are derived by the engine, and reconciliation against the
code scan turns deleted tests into visible `drift` instead of silent lies.

## Consequences
- No `Tests/` domain exists in this vault, by design.
- Adding a scenario without a test is allowed but visible — the dashboard
  counts it.

## Open questions